Tutorial: ...Preparing Bookends Plus to Reply to a Web Access
             ...Preparing a Reference Database to Reply to a Web Access
             ...Accessing a Bookends Plus Database from the Web

Preparing Bookends Plus to Reply to a Web Access

1. Create an alias of Bookends Plus (in the Finder, click once on Bookends Plus and select Make Alias from the File menu).

2. Rename the alias “Bookends.cgi” (without the quotation marks).

3. Place the alias in the same folder as the server application (e.g. MacHTTP or WebStar). The alias should be at the same level as MacHTTP or WebStar, not in a subfolder.

4. Launch MacHTTP or WebStar (or whatever server application you are using).

 Preparing a Bookends Reference Database to Reply to a Web Access

1. If it is not already open, launch Bookends Plus and open the Bookends Tutor database. This is very important—Bookends must be running to reply to a Web access. If no reference database has been opened, Bookends Plus will return the error message: Bookends can't understand this request when it receives a Web access.

2. If you have not already done so, import the references in the “Sample Import” file.

3. Select “Preferences” from the Edit menu. You should see this at the bottom of the third page:

When Bookends to front on web access is checked, Bookends will become the front-most application whenever it detects a Web request. This is not necessary, but it greatly speeds up searching for references and formatting them for the reply.

When “Hide when in background” is checked, the Bookends' window will become invisible when it is waiting in the background for a Web request. This is often desirable when Bookends Plus is running on a Macintosh being used for multiple purposes. To make going back and forth from this document to Bookends Plus easier it is probably better to leave this unchecked while you are completing this tutorial.

Click on the “Done” button to return to the reference window.

4. Select Bibliography Formatter from the Biblio menu. Make sure the Adv. Cancer Res. format you transferred from the Format Bank and edited is listed.

+  
Bookends always formats references “as HTML” when replying to a Web
          request, so it doesn't matter whether this box is checked or not if Bookends is
          creating a bibliography in response to a Web access.

 Accessing a Bookends Plus Database from the Web

1. Place the file “Tutorial.html” (an HTML-encoded Web page provided with this package in the folder named “Tutorial Items”) in the same folder as your server software (e.g. MacHTTP or WebStar). Do not place it in a subfolder!

2. Turn on your modem (if necessary) and connect to the Internet. Launch your Web browser (Netscape Navigator, Microsoft Internet Explorer, etc.).

+
  If you are using a modem you will probably have software such as FreePPP or
        MacPPP that connects you to the Internet. If you have  direct access (via Ethernet,
        for example), you are already connected.

3. If you have not already done so, launch MacHTTP or WebStar (or whatever server application you are using).

4. Enter the URL of your Mac server followed by a slash and the words “Tutorial.html” into the location field of your browser, then press Return. For example, you might enter:

                     
http://yourURL/Tutorial.html

where yourURL might be something like

                     someone.bidnet.com

       or

                     123.456.789.321

+  You can find the URL for your Macintosh by referring to the MacTCP or TCP/IP
         (if you are using Open Transport) control panel.

+ Do not simply Open the Tutorial.html document from the File menu! Although
       you will be able to examine the HTML-encoded page, you will not be able to send
       requests to Bookends Plus.

If you get an error message, double check that you are in fact connected to the Internet.

5. Examine Tutorial.html as it appears in your browser. It is an example of how a Web page accessing Bookends Plus might look, and provides some on-screen documentation about the keywords that you can send to Bookends to perform specific functions.

6. Try some of the different options on this Web page. If you have set up everything as detailed above, you should be able to search the Bookends Tutor database with the “form” provided in Tutorial.html, or directly link to the first reference in the database with the hypertext link provided at the end of the page. For example, search for “Apple”.

Note that when you access Bookends Plus from your browser, Bookends comes to the front (if this setting was selected in Preferences). This greatly speeds up operation. Remember that remote users will not see this, because they are not running Bookends Plus on their computers.

Return to your browser—you should see the results of the search you just performed. Depending on the settings of the other parameters in the form, you might see the following information returned:

Change the parameters in the search form on the Web page and search again. Use the hypertext link at the bottom of the Web page to retrieve the first reference.

7. You can open Tutorial.html in a word processor (or with SimpleText) and edit it (for example, change the wording in the hypertext link and set it to access reference 3 instead of 1). Reload the modified Tutorial.html with your browser (again, do not simply open it from the File menu) and try it again.